7.2.2 創建數位幣任意金額掃碼支付訂單（商家自訂匯率）

#簡單描述：數位幣充值業務接口，用戶透過掃描二維碼的方式將 USDT（Tether）充值到他們的數位錢包帳戶（商家自訂匯率，需登入商家後台設定）

要求方式: POST
請求介面: https://网关域名/wallet-trade-merchant/v1/receive/blockchain/any/custom/rate/create
請求媒體類型( JSON 資料格式 )Content-Type: application/json

請求參數

參數名稱	類型	必填	參數意義	參數說明
`key`	`string`	是	商家 key	apiKey
`localOrderId`	`string`	是	商家平臺本地訂單號碼	商家平臺本地產生唯一訂單號碼
`localUserId`	`string`	否	商家平臺本機使用者ID	商家平臺本機使用者ID
`notifyUrl`	`string`	否	回呼位址	下單成功後，由 API 回呼通知商家的位址（回調詳情說明在最下方）
`successRedirectUrl`	`string`	否	跳轉位址	成功後自動跳轉位址
`currency`	`string`	是	訂單計價幣種	計價幣種(錢包支持幣種)
`userCurrency`	`string`	是	用戶支付幣種	需要用戶支付的幣種(錢包支援的數位幣種)
`amount`	`number`	否	用戶預計支付金額
`isBlockchain`	`boolean`	否	是否回傳區塊鏈資訊（預設false）	當為true時，回呼請求會攜帶訂單鏈上交易資訊
`networkLimits`	`array`	否	主網	指定的支付主網，如 TRON、BSC、POLYGON、ETHEREUM
`expireSecond`	`Long`	否	過期時間戳記（秒）
`sign`	`string`	是	簽章	詳情請見簽章演算法

請求 json 範例

{
  "key": "9yUreYgTRtit39Dy",
  "localOrderId": "1732322-111",
  "notifyUrl": "http://127.0.0.1:8080/merchant-demo/notify",
  "amount": 8,
  "currency": "CNY",
  "userCurrency": "USDT",
  "networkLimits": ["TRON"],
  "isBlockchain": true,
  "sign": "6c82150ae89fc0fa202f98c92023ef04"
}

回應 json 範例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
    "orderId": 274185964909271,
    "localUserId": null,
    "localOrderId": "1732322-111",
    "orderType": "PAYMENT",
    "orderBizType": "PAYMENT_ANY_USDT_WALLET_SCAN",
    "paymentUrl": "https://walletapi.vapyapp.com/any-amount-pay/NanZCtCLCcFQbqbPyy3KJkFPYNTaZGuGjyibkAVjVuebjHWi2QuVrM5QUxg4",
    "publicKey": "NanZCtCLCcFQbqbPyy3KJkFPYNTaZGuGjyibkAVjVuebjHWi2QuVrM5QUxg4"
  }
}

返回的 paymentUrl 彈出付款頁面，如下圖：

![img](/dx-docs/7- 7、数字币代收（充值）/7.2 数字币任意金额扫码/usdt.jpg)

回應data 參數說明

參數名稱	類型	參數意義	參數說明
`orderId`	`string`	訂單 ID
`localUserId`	`string`	商家本地用戶 ID
`localOrderId`	`string`	商家本地訂單號碼
`orderType`	`enum`	訂單類型	`PAYMENT:支付订单 WITHDRAW:提款订单`
`orderBizType`	`enum`	訂單業務類型	orderBizType 類型說明如下
`paymentUrl`	`string`	付款位址
`publicKey`	`string`	公共存取金鑰

orderBizType 類型說明：

1、PAYMENT_WALLET_SCAN MINPAY錢包掃碼支付 2、PAYMENT_TRANSFER 數位幣綁定地址直充 3、PAYMENT_ANY_DIGITAL_SCAN 數位幣任意金額掃碼支付 4、WITHDRAW_WALLET 提款至MINPAY錢包 5.WITHDRAW_ANY_DIGITAL_WALLET 提款數位幣至任意錢包 6、PAYMENT_FIXED_DIGITAL_SCAN 數位幣限定金額掃碼支付 7、BATCH_PAY 大量代付

回呼返回 json 資料

預設所有回呼參數參與驗簽，回呼參數詳情請看回呼

回呼 data

{
  "amount": 8,
  "bizType": "PAYMENT_FIXED_DIGITAL_SCAN",
  "blockchain": {
    "network": "TRON",
    "receiverAddress": "TA1jptT16DssYWVGdVyFWxonku6hWK7En3",
    "senderAddress": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
    "txId": "24d0d0e5d417bd2195c45d64724760ae47fc3b359ee31c5fedf25b40f3584b36"
  },
  "currency": "USDT",
  "key": "h3cS7dBltRU4W1wD",
  "localOrderId": "2820",
  "merchantActualAmount": 8.86,
  "extra": {
    "quoteAmount": 10,
    "quoteCurrency": "CNY",
    "quotePrice": 10
  },
  "merchantCurrency": "CNY",
  "merchantId": 303122065665,
  "merchantPaidAmount": 10.98,
  "merchantUserId": "97",
  "notifyTime": 1731572168370,
  "orderCreateTime": 1731572133082,
  "orderId": "273124814912907",
  "sign": "699806308a9e055114c378671b0d2a15",
  "status": "SUCCESS",
  "type": "PAYMENT",
  "userAmount": 1.55,
  "userCurrency": "USDT",
  "userReceivableAmount": 1.55
}

參數名稱	類型	參與簽名	參數意義	參數說明
`amount`	`decimal`	是	訂單金額
`bizType`	`enum`	是	訂單類型
`blockchain`	`object`	是	鏈交易資訊	當下單請求參數isBlockchain為true，回呼請求會攜帶此物件資訊。（只涉及鏈上交易時，isBlockchain參數會生效）
└network	`String`	是	主網
└receiverAddress	`String`	是	接收位址
└senderAddress	`decimal`	是	傳送位址
└txId	`String`	是	交易ID
`currency`	`String`	是	幣種
`key`	`String`	是	商家 key
`localOrderId`	`String`	是	本地訂單號碼
`merchantActualAmount`	`decimal`	是	商家實際收款金額
`merchantCurrency`	`String`	是	商家收款幣種	預設幣種
`merchantId`	`String`	是	商家號碼
`merchantPaidAmount`	`decimal`	是	商家收款金額
`merchantUserId`	`String`	是	用戶 id
`notifyTime`	`long`	是	回呼時間
`orderCreateTime`	`long`	是	訂單建立時間
`orderId`	`String`	是	訂單號碼
`status`	`String`	是	付款狀態
`type`	`String`	是	訂單類型	`PAYMENT:支付 WITHDRAW：提款`
`userAmount`	`decimal`	是	用戶付款金額
`userCurrency`	`String`	是	用戶支付幣種
`sign`	`String`	否	md5 簽章	詳情看簽名演算法
`extra`	`object`	是	包含一下參數
└quoteAmount	`number`	是	訂單報價金額
└quoteCurrency	`number`	是	訂單報價幣種
└quotePrice	`string`	是	訂單報價價格
`userReceivableAmount`	`string`	是	用戶應付金額

當您收到回呼通知後，請在處理完成後直接返回字串 success，表示已成功接收並處理該訊息。系統在收到 success 回應後，將不再對該筆回呼進行重複發送。若未收到期望回應（未回傳 success 或回傳異常），系統將依照階梯式重試機制重新傳送回呼通知，最多重試 14 次。當前重試時間間隔依序為： 15s, 15s, 30s,180s, 600s, 1200s, 1800s, 1800s, 1800s,3600s,10800s,10800s,21600s, 21600s

請求參數​

請求 json 範例​

回應data 參數說明​

orderBizType 類型說明：​

回呼返回 json 資料​